'.\" t
.TH "lems.pl" "1M" "Dec 4, 2010" "1\&.4\&.9"
.SH NAME
lems.pl \- Linuxha.net Lems Daemon

.SH SYNOPSIS
.TS
l.
lems.pl \fB-A|--application\fP \fIapp\fP \fB--check\fP [\fB-V|--verbose\fP]
        [\fB--file\fP \fIF\fP] [\fB--config\fP \fIfile\fP] [\fB--clustercfg\fP \fIfile\fP]
        [\fB--errfile\fP \fIF\fP]
	Check Configuration for specified application

lems.pl \fB-A|--application\fP \fIapp\fP [\fB-V|--verbose\fP] [\fB--detach\fP]
        [\fB--file\fP \fIF\fP] [\fB--config\fP \fIfile\fP] [\fB--clustercfg\fP \fIfile\fP]
        [\fB--errfile\fP \fIF\fP]
        Start the Lems Daemon for the application

lems.pl \fB-?\fP
        Show brief usage information
.TE

.SH DESCRIPTION
The \fIlms.pl(1M)\fP is the daemon that each running application starts
to monitor the environment for that application. It is driven by
a configuration file - see \fIlems.xml(5)\fP for details. Typically the
configuration file will contain a file system synchronisation monitor
and one or more entries for process monitors relevant to the current
application.

The \fB--check\fP argument is useful for validating the syntax of the
configuration file without actually performing any monitoring.
.SH ARGUMENTS
The following command line arguments are supported:

.TP 4
.B * --application
The name of the application that is being monitored.
.TP
.B * --config
Override the default configuration filename which is typically lems.local.xml
in the /etc/cluster/APPNAME directory.
.TP
.B * --file
Where to log standard output to (overriding the default location).
.TP
.B * --errfile
Where to log standard error to (overriding the default location).
.TP
.B * --detach
Run the process in the background as a true daemon rather than a foreground
process.
.TP
.B * --check
Perform a syntax check only - do not actually start the monitoring.
.TP
.B * --verbose
Verbose mode - show progress messages as well as warnings and errors.

.SH FILES
The following files are referenced by this utility:

.TP 10
/etc/cluster/clconf.xml
The cluster configuration file which must exist for the utility to start.
.TP 10
/etc/cluster/.resources
The resources information is referred to since it contains the port
details for the utility to listen on for requests.
.TP 10
/etc/cluster/APPNAME/lems.local.xml
The default name of the configuration file used by the utility for the
application in question.
.TP 10
/var/log/cluster/lems/APPNAME.log
The default log name for standard output.
.TP 10
/var/log/cluster/lems/APPNAME.stderr
The default log name for standard error.

.SH EXIT STATUS
The \fIlems.pl(1M)\fP utility typically only makes use of two exit codes:

.TP 4
0
The utilty has exited successfully. This is mostly useful when using the
\fB--check\fP flag since typically the daemon runs in the background
indefinitely.
.TP
1
The utility failed to start or the check mode failed.

.SH SEE ALSO
.TS
l l.
clbuild(1M)	- Build Cluster Topology
clbuildapp(1M)	- Build / Synchronise cluster application 
cldaemonctl(1M)	- Manage or query cluster daemon
clform(1M)	- High level cluster formation tool
clhaltapp(1M)	- Halt a clustered application
clhbd(1M)	- Cluster heartbeat daemon
cllockd(1M)	- Cluster locking daemon
clnetd(1M)	- Cluster network monitor daemon
clstat(1M)	- Show cluster status information
clstart(1M)	- Cluster formation on reboot tool
clstartapp(1M)	- Start a clustered application
clconf.xml(5)	- Overall cluster topology configuration file
appconf.xml(5)	- Configuration of an application used by the cluster
.TE

.SH AUTHOR
The \fIlems.pl(1M)\fP utility was written by Simon Edwards, 2003 - 2010. The
author can be contacted via the website mentioned below.

.SH AVAILABILITY
This software is freely available from the Linuxha website - please see
\fBhttp://www.linuxha.net\fP for more details.

.SH WARRANTY
This is Open Source Software is per the GNU GPL. It is free to use and
distribute but \fIcomes with no warranty whatsoever\fP. For more information
on the license please see \fBwww.gnu.org/copyleft/gpl.html\fP.

